home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Web Server / Apache Configuration Editor.EXE / httpd.conf-dist < prev    next >
Text File  |  1998-10-03  |  10KB  |  270 lines
  1. # This is the main server configuration file. See URL http://www.apache.org/
  2. # for instructions.
  3.  
  4. # Do NOT simply read the instructions in here without understanding
  5. # what they do, if you are unsure consult the online docs. You have been
  6. # warned.  
  7.  
  8. # Originally by Rob McCool
  9.  
  10. # Dynamic Shared Object (DSO) Support
  11. #
  12. # To be able to use the functionality of a module which was built as a DSO you
  13. # have to place corresponding `LoadModule' lines at this location so the
  14. # directives contained in it are actually available _before_ they are used.
  15. # Please read the file README.DSO in the Apache 1.3 distribution for more
  16. # details about the DSO mechanism and run `httpd -l' for the list of already
  17. # built-in (statically linked and thus always available) modules in your httpd
  18. # binary.
  19. #
  20. # Example:
  21. # LoadModule foo_module libexec/mod_foo.so
  22.  
  23. # ServerType is either inetd, or standalone.
  24.  
  25. ServerType standalone
  26.  
  27. # If you are running from inetd, go to "ServerAdmin".
  28.  
  29. # Port: The port the standalone listens to. For ports < 1023, you will
  30. # need httpd to be run as root initially.
  31.  
  32. Port 80
  33.  
  34. # HostnameLookups: Log the names of clients or just their IP numbers
  35. #   e.g.   www.apache.org (on) or 204.62.129.132 (off)
  36. # The default is off because it'd be overall better for the net if people
  37. # had to knowingly turn this feature on.
  38.  
  39. HostnameLookups off
  40.  
  41. # If you wish httpd to run as a different user or group, you must run
  42. # httpd as root initially and it will switch.  
  43.  
  44. # User/Group: The name (or #number) of the user/group to run httpd as.
  45. #  On SCO (ODT 3) use User nouser and Group nogroup
  46. #  On HPUX you may not be able to use shared memory as nobody, and the
  47. #  suggested workaround is to create a user www and use that user.
  48. #  NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
  49. #  when the value of (unsigned)Group is above 60000; 
  50. #  don't use Group #-1 on these systems!
  51.  
  52. User nobody
  53. Group #-1
  54.  
  55. # ServerAdmin: Your address, where problems with the server should be
  56. # e-mailed.
  57.  
  58. ServerAdmin you@your.address
  59.  
  60. # ServerRoot: The directory the server's config, error, and log files
  61. # are kept in.
  62. # NOTE!  If you intend to place this on a NFS (or otherwise network)
  63. # mounted filesystem then please read the LockFile documentation,
  64. # you will save yourself a lot of trouble.
  65.  
  66. ServerRoot "@@ServerRoot@@"
  67.  
  68. # BindAddress: You can support virtual hosts with this option. This option
  69. # is used to tell the server which IP address to listen to. It can either
  70. # contain "*", an IP address, or a fully qualified Internet domain name.
  71. # See also the VirtualHost directive.
  72.  
  73. #BindAddress *
  74.  
  75. # ErrorLog: The location of the error log file. If this does not start
  76. # with /, ServerRoot is prepended to it.
  77.  
  78. ErrorLog logs/error_log
  79.  
  80. # LogLevel: Control the number of messages logged to the error_log.
  81. # Possible values include: debug, info, notice, warn, error, crit,
  82. # alert, emerg.
  83.  
  84. LogLevel warn
  85.  
  86. # The following directives define some format nicknames for use with
  87. # a CustomLog directive (see below).
  88.  
  89. LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
  90. LogFormat "%h %l %u %t \"%r\" %>s %b" common
  91. LogFormat "%{Referer}i -> %U" referer
  92. LogFormat "%{User-agent}i" agent
  93.  
  94. # The location of the access logfile (Common Logfile Format).
  95. # If this does not start with /, ServerRoot is prepended to it.
  96.  
  97. CustomLog logs/access_log common
  98.  
  99. # If you would like to have an agent and referer logfile uncomment the
  100. # following directives.
  101.  
  102. #CustomLog logs/referer_log referer
  103. #CustomLog logs/agent_log agent
  104.  
  105. # If you prefer a single logfile with access, agent and referer information
  106. # (Combined Logfile Format) you can use the following directive.
  107.  
  108. #CustomLog logs/access_log combined
  109.  
  110. # PidFile: The file the server should log its pid to
  111. PidFile logs/httpd.pid
  112.  
  113. # ScoreBoardFile: File used to store internal server process information.
  114. # Not all architectures require this.  But if yours does (you'll know because
  115. # this file is created when you run Apache) then you *must* ensure that
  116. # no two invocations of Apache share the same scoreboard file.
  117. ScoreBoardFile logs/apache_runtime_status
  118.  
  119. # The LockFile directive sets the path to the lockfile used when Apache
  120. # is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
  121. # USE_FLOCK_SERIALIZED_ACCEPT. This directive should normally be left at
  122. # its default value. The main reason for changing it is if the logs
  123. # directory is NFS mounted, since the lockfile MUST BE STORED ON A LOCAL
  124. # DISK. The PID of the main server process is automatically appended to
  125. # the filename. 
  126. #
  127. #LockFile logs/accept.lock
  128.  
  129. # ExtendedStatus controls whether Apache will generate "full" status
  130. # information (ExtendedStatus On) or just basic information (ExtendedStatus
  131. # Off) when the server-status Handler is called. The default is Off.
  132. #
  133. #ExtendedStatus On
  134.  
  135. # ServerName allows you to set a host name which is sent back to clients for
  136. # your server if it's different than the one the program would get (i.e. use
  137. # "www" instead of the host's real name).
  138. #
  139. # Note: You cannot just invent host names and hope they work. The name you 
  140. # define here must be a valid DNS name for your host. If you don't understand
  141. # this, ask your network administrator.
  142. # If your host doesn't have a registered DNS name, enter its IP address here.
  143. # You will have to access it by its address (e.g., http://123.45.67.89)
  144. # anyway, and this will make redirections work in a sensible way.
  145.  
  146. #ServerName new.host.name
  147.  
  148. # Optionally add a line containing the server version and virtual host
  149. # name to server-generated pages (error documents, ftp directory listings,
  150. # mod_status and mod_info output etc., but not SSI generated documents).
  151. # Set to "EMail" to also include a mailto: link to the ServerAdmin.
  152. # Set to one of:  On | Off | EMail
  153. ServerSignature on
  154.  
  155. # UseCanonicalName:  (new for 1.3)  With this setting turned on, whenever
  156. # Apache needs to construct a self-referencing URL (a url that refers back
  157. # to the server the response is coming from) it will use ServerName and
  158. # Port to form a "canonical" name.  With this setting off, Apache will
  159. # use the hostname:port that the client supplied, when possible.  This
  160. # also affects SERVER_NAME and SERVER_PORT in CGIs.
  161. UseCanonicalName on
  162.  
  163. # CacheNegotiatedDocs: By default, Apache sends Pragma: no-cache with each
  164. # document that was negotiated on the basis of content. This asks proxy
  165. # servers not to cache the document. Uncommenting the following line disables
  166. # this behavior, and proxies will be allowed to cache the documents.
  167.  
  168. #CacheNegotiatedDocs
  169.  
  170. # Timeout: The number of seconds before receives and sends time out
  171.  
  172. Timeout 300
  173.  
  174. # KeepAlive: Whether or not to allow persistent connections (more than
  175. # one request per connection). Set to "Off" to deactivate.
  176.  
  177. KeepAlive On
  178.  
  179. # MaxKeepAliveRequests: The maximum number of requests to allow
  180. # during a persistent connection. Set to 0 to allow an unlimited amount.
  181. # We reccomend you leave this number high, for maximum performance.
  182.  
  183. MaxKeepAliveRequests 100
  184.  
  185. # KeepAliveTimeout: Number of seconds to wait for the next request
  186.  
  187. KeepAliveTimeout 15
  188.  
  189. # Server-pool size regulation.  Rather than making you guess how many
  190. # server processes you need, Apache dynamically adapts to the load it
  191. # sees --- that is, it tries to maintain enough server processes to
  192. # handle the current load, plus a few spare servers to handle transient
  193. # load spikes (e.g., multiple simultaneous requests from a single
  194. # Netscape browser).
  195.  
  196. # It does this by periodically checking how many servers are waiting
  197. # for a request.  If there are fewer than MinSpareServers, it creates
  198. # a new spare.  If there are more than MaxSpareServers, some of the
  199. # spares die off.  These values are probably OK for most sites ---
  200.  
  201. MinSpareServers 5
  202. MaxSpareServers 10
  203.  
  204. # Number of servers to start --- should be a reasonable ballpark figure.
  205.  
  206. StartServers 5
  207.  
  208. # Limit on total number of servers running, i.e., limit on the number
  209. # of clients who can simultaneously connect --- if this limit is ever
  210. # reached, clients will be LOCKED OUT, so it should NOT BE SET TOO LOW.
  211. # It is intended mainly as a brake to keep a runaway server from taking
  212. # Unix with it as it spirals down...
  213.  
  214. MaxClients 150
  215.  
  216. # MaxRequestsPerChild: the number of requests each child process is
  217. #  allowed to process before the child dies.
  218. #  The child will exit so as to avoid problems after prolonged use when
  219. #  Apache (and maybe the libraries it uses) leak.  On most systems, this
  220. #  isn't really needed, but a few (such as Solaris) do have notable leaks
  221. #  in the libraries.
  222.  
  223. MaxRequestsPerChild 30
  224.  
  225. # Proxy Server directives. Uncomment the following line to
  226. # enable the proxy server:
  227.  
  228. #ProxyRequests On
  229.  
  230. # Enable/disable the handling of HTTP/1.1 "Via:" headers.
  231. # ("Full" adds the server version; "Block" removes all outgoing Via: headers)
  232. # Set to one of: Off | On | Full | Block
  233. #ProxyVia on
  234.  
  235. # To enable the cache as well, edit and uncomment the following lines:
  236. # (no cacheing without CacheRoot)
  237.  
  238. #CacheRoot @@ServerRoot@@/proxy
  239.  
  240. #CacheSize 5
  241. #CacheGcInterval 4
  242. #CacheMaxExpire 24
  243. #CacheLastModifiedFactor 0.1
  244. #CacheDefaultExpire 1
  245. #NoCache a_domain.com another_domain.edu joes.garage_sale.com
  246.  
  247. # Listen: Allows you to bind Apache to specific IP addresses and/or
  248. # ports, in addition to the default. See also the VirtualHost command
  249.  
  250. #Listen 3000
  251. #Listen 12.34.56.78:80
  252.  
  253. # VirtualHost: Allows the daemon to respond to requests for more than one
  254. # server address, if your server machine is configured to accept IP packets
  255. # for multiple addresses. This can be accomplished with the ifconfig 
  256. # alias flag, or through kernel patches like VIF.
  257.  
  258. # Any httpd.conf or srm.conf directive may go into a VirtualHost command.
  259. # See also the BindAddress entry.
  260.  
  261. #<VirtualHost host.some_domain.com>
  262. #ServerAdmin webmaster@host.some_domain.com
  263. #DocumentRoot /www/docs/host.some_domain.com
  264. #ServerName host.some_domain.com
  265. #ErrorLog logs/host.some_domain.com-error_log
  266. #TransferLog logs/host.some_domain.com-access_log
  267. #</VirtualHost>
  268.  
  269.  
  270.